home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Topik / Topik - Disk 36 - Archivers (19xx)(Topik Public Domain)(PD)[WB].zip / Topik - Disk 36 - Archivers (19xx)(Topik Public Domain)(PD)[WB].adf / ArchEdge / ArchEdge.doc < prev    next >
Text File  |  1990-10-07  |  15KB  |  297 lines
  1.  
  2. ****** A BUG HAS BEEN FOUND ! I CAN'T FIX IT AS YET, BUT WILL LOOK INTO IT,
  3. BUT BASICALLY THE BUG ONLY WORKS FROM WORKBENCH AND THAT IS THAT IT
  4. UNARCHIVES TO THE SYS: DIRECTORY !  SO, FOR NOW RUN IT FROM THE CLI IF
  5. YOU HAVE PROBS.  I'M WORKING ON IT ASAP....
  6. ****** Still thinking about how to fix it...sorry ! Use it from the CLI !
  7. ****** I am closer to fixing it I think...but still use from the CLI for
  8. now....
  9.  
  10. ArchEdge V3.01 - Robert Lang 27/9/90
  11. ~~~~~~~~~~~~~~
  12.     "The Edge in Archiving"
  13.  
  14. Wow!  I've actually written something useful.  Many years of programming
  15. have served ME well, but this is the first time I've actually taken the
  16. plunge and let other people get the benefit from my coding.  Hope you like
  17. it !  Earlier versions are pretty popular around my area, hence the reason
  18. I made it neat and decided to release.  I'm calling my section of the PD
  19. market "Edgeware" and so anything addressed perhaps should be addressed to
  20. me because Edgeware is simply a nickname at the moment...and doesn't really
  21. exist as anything in the legal world.
  22.  
  23. Rules, Disclaimers, and Where to find me:
  24. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  25.  
  26. I'm keeping all rights to this program, but allowing anyone to share it
  27. around in the format in which it was supplied to them, meaning you can't
  28. dissassemble it and change anything, or spread the code, or add your name,
  29. or anything but use it and copy it really !  I don't take any responsibility
  30. for any damage done when using ArchEdge..its PD, and so not guaranteed to
  31. do anything really!  If you like it, then you can send $20 to me, and you'll
  32. receive the latest version and docs on a bootable disk, and be put on my
  33. soon-to-be-formed mailing list for notification of future releases.
  34. Alternatively,  if that's too much, then just send $5 and a disk, and
  35. I'll wack ArchEdge latest version on a disk with docs, and not put you on
  36. the mailing list.  (I can be bribed easily, though, so buzz me and offer
  37. anything at all that's not illegal or immoral [hahahahahaha] )
  38. Also, please feel free to send comments, large unbouncable cheques made
  39. out to me, large amounts of spendable-in-the-20th-century cash,
  40. Porsches (REAL ones...), or anything else to me:
  41.  
  42.             Robert Lang
  43.             (EDGEWARE)
  44.             P.O. Box 127
  45.             CARDIFF NSW 2285
  46.             AUSTRALIA
  47.  
  48. You can also try and ring me for a chat....049-508189....but I'm usually
  49. whizzing around from Uni to home, and so I'm hard to get hold of.  If you
  50. leave a message with my Mum, then don't be assured of getting a return call
  51. if you are long distance...sorry, I just can't afford it.  You can also
  52. netmail me via:
  53.  
  54. Communications2000 BBS (Ph: 049-592664 or FidoNet: 3:622/495)
  55.  
  56. And I would expect that is about the best option.  Please send bug reports!
  57. I will be updating ArchEdge slowly, and would love to make all who use it
  58. happy, so if you find a glitch, then note it and tell me !
  59.  
  60. ABOUT ARCHEDGE and thanks:
  61. ~~~~~~~~~~~~~~~~~~~~~~~~~
  62.  
  63. ArchEdge is written in 68000 Assembly, now using the Macro68 Assembler.
  64. See my review on Megadisc for your info, but get it ! Its the best, and
  65. I mean buy it of course ! Keep programmers programming !
  66. I use an Amiga 2500 which has a 44 Mb Hard Drive, 3 Mb of RAM,
  67. a 68020/68881 accelerator board (A2620), and for modemming I use a
  68. Bit Blitzer 1234E modem, GPTERMV4.0, a 1081 monitor and my Amy is
  69. pumped through a 30 watt amplifier for nice ear-bashing sound.
  70.  
  71. Note that ArchEdge is proudly familiar to GPTERM and Macro68 !  How ?
  72. They are all Australian Made, proving that Aussie products have class....
  73.  
  74. Thanks to the writers of the three books, all bearing the ABACUS label:
  75.  
  76.         Amiga Machine Language
  77.         Amiga System Programmers Guide
  78.     and Advanced System Programmers Guide
  79.  
  80. These books are invaluable to me, and so if you haven't got them, then
  81. there's a hint for you !
  82.  
  83. AND a special thanks to Suzanne Day, my girlfriend, who somehow puts up
  84. with me and my computer.  (Falling asleep on a date for example, because
  85. I was up the night before till 4 am programming!). ArchEdge is specifically
  86. dedicated (well, they do it with books, don't they ???) to Suzanne...
  87.  
  88. I could go on with thanks to my parents for making me, and make a real long
  89. Stevie Wonder speech....but I'll save you the hassle.....
  90.  
  91. ARCHEDGE V3.01 DOCS (wow...at last ???)
  92. ~~~~~~~~~~~~~~~~~~~
  93.  
  94. Ok.  ArchEdge can be started from the CLI (by entering its name when in the
  95. relevant directory) or the Workbench (by clicking on its icon).  Either
  96. way, at this stage it opens its own CLI output windows when doing DOS
  97. stuff.  If this is a hassle for CLI users, then tell me, and I'll switch
  98. off the CON: windows for the CLI execution case.
  99.  
  100. ArchEdge has menus....these work the same as any of the mentioned
  101. options, and include hotkeys.  They can easily be worked out yourself by
  102. pressing the right mouse button when ArchEdge is running !
  103.  
  104. When started in the CLI, then it takes options by putting them directly
  105. after the space after the ArchEdge name, following a - !  The only option
  106. at this time is the auto iconify.
  107. Type ArchEdge -i and it automatically hides away.  I will add a routine
  108. to make it auto detach soon as I figure out how, but for now just put it
  109. in your startup-sequence as runback ArchEdge -i and its ready when you
  110. need it !
  111.  
  112. ArchEdge now unzips using the supplied command UNZIP.  Note that it won't
  113. ZIP a file, because the Amiga Zipper is a self-contained program !
  114.  
  115. In 2.4, I added a config file.  This is called "ArchEdge.config" and is
  116. located in the current directory when ArchEdge is run or in the s:
  117. directory.  This will expand more, but at the moment is one line of 18
  118. characters.  There 18 characters are 3 characters each for the custom
  119. path gadgets.  Eg.  Here is my config file :
  120.  
  121.         DF0DF2DH0DH1RAMRAM
  122.  
  123. And so ArchEdge takes the characters in threes and adds a : to them, so I
  124. get DF0:,DF2:,DH0:, etc....You could put RAD:, or DH2:, DF1:, whatever you
  125. like.  Also, if you use a directory a lot like uploads, then put in your
  126. startup-sequence :
  127.  
  128.         Assign UPL: <PATH>:Uploads
  129.  
  130. And put UPL in the ArchEdge.config file and it will select UPL: when you
  131. click on it !  Great !  More to come on the config side.....
  132.  
  133. When started from the CLI, it has a neat little option....see further on
  134. how to UNDO one file only....
  135.  
  136. Things have changed if you saw an earlier version, mainly because I rewrote
  137. the file requester.  Its more friendlier (?) now....just point and click
  138. and even drag to select multiple files if you like.  You will not the
  139. effect of NODIRS by playing.  With NODIRS on, you can't drag-select a
  140. directory, but if you click on a directory once and AUTO-DIR is on, it will
  141. move into the path.  But if AUTO-DIR if off and NODIRS is on, there should
  142. be no way to select a Directory.  Note that CLR and ALL have the effect
  143. of unselecting or selecting (respectively) everything, and READ re-reads
  144. the current path.
  145.  
  146. ArchEdge now wants you to enter or select a path.  Entering one involves
  147. clicking on the path gadget, the upper box at the bottom right of the main
  148. window, indicated by "From Path" and entering the pathname you want to
  149. select.  You can select one by clicking on any of the device gadgets at
  150. the bottom right of the window.  These are not disabled if certain devices
  151. aren't available at the moment, they simply copy RAM: or DF2: etc into
  152. the pathname box.
  153.  
  154. The AUTO-DIR gadget allows entry into directories by clicking them in the
  155. file requester if it (the AUTO-DIR gadget) is on.  This is there to support
  156. a later option of archiving whole directories.  For the moment,
  157. a selected directory will produce unexpected results in an archiving
  158. operation, most likely it will not archiver the directory...at least
  159. that's what LHARC does.
  160.  
  161. The PARENT gadget is the little '/' at the end of the path requester which
  162. takes you to the previous directory in the pathname.
  163.  
  164. The POP gadget moves ArchEdge into the background up the top waiting for
  165. you to summon it do its chores.  Simply click on it first with the left
  166. mouse button (to select it...) and then with the Right...and its back
  167. again with full fury !  Notice that the POP window is not auto-selected
  168. so that it won't disrupt things when using the -i option in a startup.
  169.  
  170. The AUTO-PAD gadget decides if you want a file added to the end of the
  171. archive to ensure that modem transfers which sometimes cut off the end of
  172. files don't cut off something important...only my file.  The file added is
  173. a little advertisement for ArchEdge created in RAM when started and deleted
  174. when finished !
  175.  
  176. The DELETE gadget allows you to delete files or directories that are
  177. selected.  When clicked, you are given a warning and asked YES or NO to
  178. confirm.  You can also cancel by closing the requester window.  If
  179. directories are selected you get a further question as to whether you want
  180. them and their contents deleted....again close to cancel or YES or NO as
  181. desired.
  182.  
  183. The OKAYS option will turn on or off the "CLICK BEGIN TO...." messages that
  184. appear when you go to do something....this makes archiving and de-archiving
  185. a lot quicker if you are careful and take note of what you are doing !
  186.  
  187. Directories appear as a separate colour to the files in the file requester,
  188. The file requester sorts the directory into alphabetical order.
  189.  
  190. Archiving is done by simply clicking on the files you wish to archive, and
  191. selecting LHARC, ARC, or ZOO.  If Okays is on, you will be asked to click
  192. BEGIN if the path and filename set in the "TO" boxes is correct, or close
  193. the window if you want to change or fix anything.  NOTE : With OKAYS off,
  194. you won't get these warnings !!! THINK ABOUT IT !!
  195.  
  196. You always get LHWARP and DELETE warnings, regardless of OKAYS.
  197.  
  198. And away it will go !  Creating the archive with the first file, and then
  199. adding each successive file to the archive.  Easy as that.  Very little
  200. error-handling is done at the moment, but in the event that you wish to
  201. stop archiving, click on the close gadget of the ArchEdge Requester and
  202. wait for the current command to finish and ArchEdge will return to its
  203. own window.
  204.  
  205. The procedure is the same for ZOO, ARC, and LHARC.  My suggestion is to
  206. use LHARC, as it is most effective and slowly becoming most popular,
  207. although not as fast as ZOO...so if its a quick archive you want, ZOO it.
  208.  
  209. ArchEdge used to use a PD program called UNDO.  Now it uses custom routines
  210. by me, with colourful outputs and the like.  You can also now use ArchEdge
  211. as you could UNDO.  Simply type ARCHEDGE archivename and it will decide
  212. what sort of archive the "archivename" is and unarchive it into the
  213. current directory.  The whole program will not be run, and so this is good
  214. for single file stuff !  If you type ArchEdge ? you will get a little
  215. instruction screen...wow ! Its a CLI program and a WB program....
  216.  
  217. The LIST gadget works the same as the UNDO, except it lists the contents
  218. of the archive where possible, and waits for a RETURN between each archive.
  219.  
  220. If OWNDIR is on, ArchEdge unarchives by making a directory with the archive
  221. name, and unarchiving into that directory, to ensure that files don't get
  222.  mixed. For example, if you choose to unarchive two files "Robert.Arc" and
  223. "Suzanne.LZH" then two directories will be created in the destination
  224. path, Robert and Suzanne, and the relevant archive contents will be in
  225. the separate directories.  Neat, huh?  This overcomes a big problem with
  226. most archives containing README files, and so they would get lost or weird
  227. things could happen !
  228.  
  229. With OWNDIR off, ArchEdge just sends everything to the TO directory, so be
  230. warned....make sure you know what is in the archives and check that there
  231. won't be any problems !
  232.  
  233. Well, that leaves LHWARPing.  Clicking the LHWARP gadget brings up all the
  234. options, and BEGIN starts it....so be warned...have EVERYTHING ready before
  235. you click begin.  Notice that I rename like this :
  236.                        rename FILENAME.LHW to FILENAME.LHW.BAK
  237.                                         command before the LHWARP command,
  238. this is because it locks up if it finds an existing archive of the name
  239. and path you told it to make one, so I rename your old one to protect it.
  240. I use the internal RENAME function, so you don't need RENAME command....
  241.  
  242. The options for LHWARP are best explained in its own documents....they are
  243. all there.  You select the drive, and the compressing options (quick is
  244. quickest, but worst, and Freeze is best) and the bitmap options (use the
  245. bitmap for most efficient), and enter the name with full path, and away it
  246. goes !
  247.  
  248. The textfile added when AUTO-PADding is also added to LHWARP archives, and
  249. is displayed when de-archiving.  At present you have no choice but to let
  250. this happen !
  251.  
  252. ArchEdge also UNLHWarps, and does this by letting you know if you click
  253. on a file with a .LHW extension!  It is straight forward from there, just
  254. select the output drive and BEGIN, but again BE WARNED!  The process
  255. starts immediately the BEGIN is clicked...so have everything ready.
  256.  
  257. That's all I can think of.  Most things can be cancelled by clicking the
  258. requester close gadget I think, and the program itself can be exited
  259. (why would you wanna do that ?) by clicking its close gadget.
  260.  
  261. I don't know of any bugs existing, but then that's because of what is
  262. classically called "Programmer's Prejudice".  You see, because I wrote
  263. the program, I am less likely to do something "wrong" in the views of the
  264. program than someone who knows zilch about the program.  Any bugs I find
  265. will be added to the top of this document, so if there isn't any, then its
  266. all going fine !
  267.  
  268. WHAT YOU NEED:
  269. ~~~~~~~~~~~~~
  270.  
  271. In the C: directory, you MUST have RUN, and all the archivers used by
  272. the current version of ArchEdge. (LHARC, ARC, ZOO, PAK, UNZIP, and LHWARP)
  273.  
  274. You could do this by copying the commands to ram: and assigning....like
  275. makedir ram:c, copy commands c:, and assign c: ram:c so you can use both
  276. drives in your archiving work. If you want to know exactly how to do this,
  277. then ask me !
  278.  
  279. THE END!
  280. ~~~~~~~~
  281.  
  282. Well, there it is!  Thanks to Bruce Paine for the actual idea
  283. of ArchEdge, and I hope you like it Bruce !   My intention is for ArchEdge
  284. to become invaluable to modem users, and I know it will with my work for
  285. TOPIK PUBLIC DOMAIN, as I frequently receive piles of archived disks, and
  286. so now I can select a batch unarchive and go and do something else while
  287. the computer works for me.
  288.  
  289. Keep in touch, and have fun with Archedge !
  290.  
  291.      Robert Lang.
  292.  
  293. Programmer for hire :-> Feel free to let me know if you have a good idea
  294. for a PD program, if I like the idea, I'll probably do it !  Also let me
  295. if you would like to pay for a program to be written....I'm open to
  296. reasonable offers.
  297.